home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / scrnsvrs / scrnsavr.lzh / ReadThis.1st < prev   
Text File  |  1992-11-13  |  8KB  |  135 lines
  1. -- What should have been in the LZH file -------------------------------------
  2.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  3.     Boink.PRG      BoinkSave Screen Saver.
  4.     BoinkCfg.PRG   The config program.
  5.     Faze.PRG       Faze Screen Saver.
  6.     Moire.PRG      Moire Screen Saver.
  7.     ReadThis.1st   This file.
  8.     Images\        A folder containing several .BSI files.
  9.  
  10. The filenames are shown in upper/lower case for your convenience; they're also
  11. stored in the .LZH this way.  All the names will become upper case when you
  12. extract files from the archive, though.
  13.  
  14. If any of the files are missing, please leave a message wherever you got this
  15. file stating that the .LZH is incomplete.  A complete version can be obtained
  16. from me if you send a blank disk to the address below.
  17.  
  18.  
  19. -- Freeware notice -----------------------------------------------------------
  20.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  21. These programs are Freeware.  You may distribute them as you see fit, but you
  22. can't charge for them, except reasonable charges to cover the cost of the media
  23. it's distributed on (read: PD/Shareware collections are okay).  This cost
  24. should not exceed $10.
  25.  
  26.  
  27. -- What this is --------------------------------------------------------------
  28.    ¯¯¯¯¯¯¯¯¯¯¯¯
  29. In the tradition of creating screen savers that are anything but tame (one of
  30. R. Glover's common complaints about screen savers), here are some screen savers
  31. I've written.
  32.  
  33.  
  34. -- Using the programs --------------------------------------------------------
  35.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  36. Put Boink.PRG, Faze.PRG, or Moire.PRG (don't use Boink and Faze at the same
  37. time) in your AUTO folder, reboot, and if you don't press a key or move the
  38. mouse for two minutes, the screen saver will go to work.  Press any key or move
  39. the mouse to restore the screen.  What the screen saver does depends on which
  40. one you use; Boink.PRG will display a bouncing, spinning ball (reminiscent of
  41. the old, old Boink demo), Faze.PRG does a slow fractal faze through some
  42. colors, and Moire draws moire patterns on the screen.  Boink.PRG consumes a
  43. whopping 43K of RAM (34K for Faze.PRG and Moire.PRG), even though it's only
  44. 10K; that's the price you pay for interesting screen savers.  Fortunately
  45. BoinkSave only consumes 12% (11% for Faze, but 40% for Moire) of processor time
  46. when actually bouncing the ball.  Both Boink and Faze should run on a TT, but I
  47. can't say for certain (I don't have a TT to test it on, do I?)  Boink and Faze
  48. won't run in monochrome; if you try, they won't install themselves.  That way
  49. you don't have to worry about turning them off when you switch monitors.
  50. Similarly, Moire will not work in color; it won't install on a color machine.
  51.  
  52. The BoinkCfg program will take some explaining.  Not that it's hard to use,
  53. just that there's a bit to it.  When you run it, from any resolution, you'll
  54. see a small alert box with three buttons on it: "Config", "Disable", and
  55. "Exit".  "Config" will bring up the configuration dialog.  "Disable" will
  56. disable the screen saver completely; you'll notice the button changes to
  57. "Enable!", which will re-enable the screen saver.  And "Exit" will turn on the
  58. screen saver and exit the program.  (The screen saver will shut off when you
  59. move the mouse or press a key, of course.)
  60.  
  61. In the "Config" dialog you will also find three buttons: "Time", "Boink", and
  62. "Exit".  Clicking on "Time" will allow you to set the time the screen saver
  63. will wait before kicking in.  Use the "<" and ">" buttons to change the time
  64. displayed; click on the time itself when you're satisfied.  "Boink" will bring
  65. up yet another dialog, allowing you to adjust aspects of the animation in
  66. BoinkSave (and only BoinkSave; these options are useless for Faze and Moire).
  67. Here you can choose "Speed", "Graphic", or "Exit".  "Speed" will allow you to
  68. choose "Fast", "Medium", or "Slow".  On an unmodified ST, these consume 23%,
  69. 12%, and 8% of processor time, respectively.  Once one of these buttons is
  70. selected, BoinkSave will activate, showing you what the speed looks like.  Move
  71. the mouse or press a key to return to the dialog.  "Graphic" will allow you to
  72. load a .BSI file (contained in the Images folder) for a different graphic; once
  73. loaded, BoinkSave will activate, so you can see the new graphic.  Move the
  74. mouse or press a key to return to the dialog.  "Exit", as with the other "Exit"
  75. buttons in the program, exits back to the previous dialog.  If you exit from
  76. the "Config" dialog, you will be asked if you want to save the configuration;
  77. click on "Okay" to save to \AUTO\BOINK.PRG, "Locate" to find a different copy
  78. of the program (or FAZE.PRG or MOIRE.PRG), or "Cancel" to abort the save.
  79.  
  80. Phew!  That's just about everything you *need* to know to use these screen
  81. savers.  There are, however, a few more things I'd like to point out.  All of
  82. these screen savers have been previously released; this time I've (hopefully)
  83. fixed a glitch in BoinkCfg (thus it's version 1.1).  This program replaces the
  84. Faze_Cfg, as it lets you configure all three screen savers from the same
  85. program.  It also lets you *disable* the screen savers, which in this case is
  86. *vital* for Spectrum & DigiSpec.  I have found no other compatibility problems
  87. with these two programs.
  88.  
  89. One more thing.  The "Disable" function only works if BoinkSave (or Faze or
  90. Moire) was the last program to install itself on the vertical blank interrupt.
  91. You can make sure this is so by placing Boink.PRG, Faze.PRG, or Moire.PRG
  92. _last_ in your AUTO folder.
  93.  
  94. Well, I didn't expect to write this much about these screen savers, let alone
  95. fix a bug.  If you have comments/questions/complaints/suggestions, you can
  96. write to:
  97.  
  98.     Damien M. Jones
  99.     PSC 8 Box 657
  100.     APO AE 09109
  101.  
  102. I wrote this program because I couldn't get the idea out of my head; I thought
  103. perhaps if I got it over and done with, I might be able to get back to my
  104. current project.  It didn't work.  Now I get all *kinds* of ideas for screen
  105. savers.  (Sigh)  Eventually I'll rewrite these for Extend-O-Save format for use
  106. with Warp 9.
  107.  
  108.     -dmj
  109.  
  110.  
  111. -- File format of .BSI files (for BoinkSave) ---------------------------------
  112.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  113. Obviously, there are some of you out there who are itching to put together your
  114. own animations for BoinkSave.  Fine, no problem.  Here's the format of the .BSI
  115. files used by BoinkCfg.PRG:
  116.  
  117. [8 bytes]     ID bytes, read "dmj³.BSI".
  118. [2 bytes]     Number of X positions to use.
  119. [2 bytes]     Number of Y positions to use.
  120. [640 bytes]   X positions; these are values ranging from 0-288, as a list of
  121.               words.  Note that even though they must all be here, they are
  122.               not always used, depending on the value listed above.
  123. [400 bytes]   Y positions; these are values ranging from 0-168, as a list of
  124.               words.  Note that even though they must all be here, they are
  125.               not always used, depending on the value listed above.
  126. [32 bytes]    Palette, in standard 16*RGB format.  May be STe if you like.
  127. [8192 bytes]  The images.  These are sixteen 32x32 rasters in four bitplanes.
  128.               If you're using GFA BASIC, you can use GET; just remember to
  129.               clip off the first six characters of the GET string, since GFA
  130.               BASIC uses that part to record the size of the image.
  131.  
  132. That's really all there is to it.  Not very complicated, but adequate for the
  133. situation.  If you get any really good .BSI's, I'd be interested in seeing
  134. them... send them to the above address.
  135.